*************
软件简介
*************

DS-PAW是Device Studio平台下一款第一性原理密度泛函计算程序，使用平面波作为基函数组，使用投影缀加平面波方法构造赝势。本程序能广泛应用于材料科学领域，开展例如金属、半导体、绝缘体、表面、磁性、非磁性、锂电等材料的计算研究；
能够精确预测材料的电子分布；能够进行原子几何结构优化等多种功能的计算。本程序性能稳定，在intel芯片及国产海光芯片下经过百万案例的内部测试，包括各项功能及并行效率。

command命令说明
====================================

list命令列表
------------------------------------

- -lic_
- -info_
- -example_
- -ipp_
- -mpi_
- -mpiargs_
- -pob_

--------------------------------------------------------------------------------------------------------------------------------------------


detail命令详细描述
----------------------------------

.. _lic:

**命令名称:** :guilabel:`-lic`

**使用方法：** :guilabel:`-lic` 用于生成序列号，在DS-PAW安装目录下执行命令：:guilabel:`DS-PAW -lic` 即可得到LicenseNumber.txt文件，该文件用于license的申请


---------------------------------------------------------------------------------------------------------------------------------------------

.. _info:

**命令名称:** :guilabel:`-info`

**使用方法：** :guilabel:`-info` 用于查看软件版权信息，执行命令：:guilabel:`DS-PAW -info`


---------------------------------------------------------------------------------------------------------------------------------------------

.. _example:

**命令名称:** :guilabel:`-example`

**使用方法：** :guilabel:`-example` 用于快速执行一次计算，可检查DS-PAW是否正确安装，执行命令：            :guilabel:`DS-PAW -example`


---------------------------------------------------------------------------------------------------------------------------------------------

.. _ipp:

**命令名称:** :guilabel:`-ipp`

**使用方法：** :guilabel:`-ipp` 用于查看DS-PAW赝势头数据信息，包括截断能、价电子数等。执行命令：           :guilabel:`DS-PAW -ipp`


---------------------------------------------------------------------------------------------------------------------------------------------

.. _mpi:

**命令名称:** :guilabel:`-mpi xxx`

**使用方法：** :guilabel:`-mpi` 用于指定mpi执行程序的位置，如： :guilabel:`-mpi mpirun`



---------------------------------------------------------------------------------------------------------------------------------------------

.. _mpiargs:

**命令名称:** :guilabel:`-mpiargs xxx`

**使用方法：** :guilabel:`-mpiargs` 用于指定mpi运行参数，如：:guilabel:`-mpiargs "-np 16"`


-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

.. _pob:

**命令名称:** :guilabel:`-pob`

**使用方法：** :guilabel:`-pob` 用于并行计算时合理分配核数加快运行速度，为 *parallel over band* 的简写，可在提交命令中添加此关键词。DS-PAW在部分功能计中无法开启pob，此时会给出warning并将pob关闭

------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------



.. _1.3 程序运行:

run程序运行
==================


submit命令提交运行
----------------------------------

设置环境变量：

.. code-block:: bash

    export PATH={DS-PAW INSTALLPATH}/bin:$PATH


串行执行：

.. code-block:: bash

    DS-PAW input.in

并行执行：

.. code-block:: bash

    DS-PAW -mpi mpirun -mpiargs "-np 16" input.in -pob

script脚本提交运行
----------------------------------

若使用排队系统（例如PBS、slurm等）提交任务，只要配置完成相应的 ``.pbs`` 或 ``.slurm`` 脚本，之后使用 :guilabel:`qsub xx.pbs`  或 :guilabel:`sbatch xx.slurm`  提交任务即可。


.. toctree::
   :maxdepth: 4

.. index:: introduction